package cn.tedu.pdfamily.product.service;

import cn.tedu.pdfamily.product.pojo.dto.UserRoleAddNewDTO;
import cn.tedu.pdfamily.product.pojo.dto.UserRoleUpdateDTO;
import cn.tedu.pdfamily.product.pojo.vo.UserRoleListItemVO;
import cn.tedu.pdfamily.product.pojo.vo.UserRoleStandardVO;

import java.util.List;

/**
 * 处理用户角色相关数据的业务接口
 *
 * @author java@tedu.cn
 * @version 0.0.1
 */
public interface IUserRoleService {

    /**
     * 添加用户角色相关
     *
     * @param userRoleAddNewDTO 用户角色相关数据
     */
    void addNew(UserRoleAddNewDTO userRoleAddNewDTO);

    /**
     * 删除用户角色相关
     *
     * @param id 尝试删除的用户角色相关的id
     */
    void delete(Long id);

    /**
     * 根据用户角色相关id，修改用户角色相关详情
     *
     * @param id             用户角色相关id
     * @param userRoleUpdateDTO 新的用户角色相关数据
     */
    void updateInfoById(Long id, UserRoleUpdateDTO userRoleUpdateDTO);

    /**
     * 根据id获取用户角色相关的标准信息
     *
     * @param id 用户角色相关id
     * @return 返回匹配的用户角色相关的标准信息，如果没有匹配的数据，将返回null
     */
    UserRoleStandardVO getStandardById(Long id);

    /**
     * 查询用户角色相关列表
     *
     * @return 用户角色相关列表
     */
    List<UserRoleListItemVO> list();

}
